home *** CD-ROM | disk | FTP | other *** search
/ Aminet 2 / Aminet AMIGA CDROM (1994)(Walnut Creek)[Feb 1994][W.O. 44790-1].iso / Aminet / dev / cross / Dis6502.readme < prev    next >
Encoding:
Text File  |  1993-11-08  |  3.0 KB  |  83 lines
  1. Short: Disassembler for the 6502-processorfamily (C64,...)
  2. Type: dev/asm
  3. Uploader: mortene@idt.unit.no
  4. Author: mortene@idt.unit.no
  5.  
  6. Dis6502 v1.00,
  7.  
  8. 6502/6510/8502/8510 disassembler,
  9.  
  10. written by Morten Eriksen, November 1993.
  11.  
  12.  
  13. Preface
  14. =======
  15.  
  16. Dis6502 is SHAREWARE and © copyright 1993 by Morten Eriksen.
  17. If you like this program, please send me $10 (or an equal amount in your
  18. own currency, cash only) and a disk to become a registered user. In return
  19. you will get the latest update. If you've got an email address, you'll get
  20. all future upgrades for free aswell. See end of document for my address.
  21. Further upgrades depends on if I get some registrations.
  22.  
  23. Dis6502 is a disassembler for the 6502-family of microprocessors. It will
  24. turn C64 (or any other 6502-based computer's) binaries into listings of
  25. CPU opcodes.
  26. Dis6502 supports all officially documented opcodes on the 6502-compatible
  27. processorfamily. Future versions will support undocumented opcodes
  28. (optionally), hardwareregister-recognition for the C64 hardwareregisters,
  29. relative offset disassembling, and a lot more. (I'm also planning to make
  30. a 6502-source to 68000-source converter, for easy, perfect conversions of
  31. those old'n'golden C64 games). If there's any interest, I could make a
  32. 6502 (cross)assembler too? (If it's not been done already.)
  33.  
  34.  
  35. Starting Dis6502
  36. ================
  37.  
  38. Start the disassembler by entering the command line:
  39.  
  40.    Dis6502 [loadadr] <filename>
  41.  
  42. Where <filename> is the 6502 binary to be loaded, and <loadadr> is an
  43. optional specification of the absolute address where the binaryfile
  44. will be disassembled relative to. Note: If you don't specify the
  45. <loadadr>, Dis6502 assumes that the loadadress is contained in the
  46. two first bytes of the file (standard C64 loadfile).
  47.  
  48. Here's two examples for you to try if you've got the PlaySid package:
  49.  
  50. Exploding Fist II:
  51. 1. Take a look at this file's icon ("Information" in one of the WB-menus).
  52.   The first number is the loadadress, second number is the initadress and
  53.   third adress is the playadress.
  54. 2. Notice that the Exploding Fist II -music and -musicroutines should be
  55.   loaded to adress $a400.
  56. 3. Start Dis6502 with:
  57.                        Dis6502 $a400 <path>/ExplodingFistII
  58.   (where <path> is the path to the Exploding Fist II musicfile).
  59. 4. Wait a while (yes, I know Dis6502 is a bit slow at the moment, will
  60.   be fixed in next version (promise)).
  61. 5. The disassembled code is now in the file <path>/ExplodingFistII.asm.
  62.  
  63. Revenge of the Mutant Camels:
  64. In this file's icon, the loadadress is 0. This means that this file's
  65. first two bytes contain the actual loadadress. Therefore, start Dis6502
  66. with:
  67.       Dis6502 <path>/RevMutantCamels    (don't specify loadadress)
  68.  
  69. Load the disassembled file, and notice that the file has been diassembled
  70. from $bfc0.
  71.  
  72.  
  73.  
  74. For questions, bug-reports, pat-on-the-backs, registrations, suggestions
  75. and ideas for further upgrades or for anything else, contact me at:
  76.  
  77.     Morten Eriksen
  78.     Jonsborgvn. 18
  79.     7563 Malvik
  80.     NORWAY
  81.  
  82. ..or by email:        mortene@idt.unit.no
  83.